You can change the dashboard layout, add and rearrange the order of the widgets in columns/rows, add/remove widgets and re-size the columns, rows, widgets etc. In the Reports Name column, click the dashboard name to open the dashboard. The Dashboard page in view mode is initially empty with a default section and row added. The instructions below describe how to enable the edit mode and rearrange your dashboard layout.
Tip: The user must have the following permission assigned to edit the custom dashboards. Admin: Permission Group: Dashboard > Edit Custom Dashboard
Click the Preview button to view the edited dashboard layout without saving the changes. To switch to Edit mode, click the Edit button.
To view all toolbars available in the Dashboard, click the Pin Editors button. This will pin and display all the toolbars on each editor. Click the button again to unpin and hide the toolbars. The Pin Editor option is also available on each toolbar.
Tip: You can also create LookUp filter widgets with display formats. Read here for detailed instructions to create the widget.
This option enables you to filter the other dashboard filters based on the value selected in the first filter, i.e. the drop-down values in the child filter will be filtered based on the value selected in the parent filter drop-down.
Note: The Parent filter must be added to the dashboard first, to enable selection when mapping the child filter with the parent filter.
Note: Select Generate Filter option when adding the page filter widgets.
The filter cogs on each widget display the global filter(s) applied. To view the filter cogs:
The labels on columns in the widgets can be dynamically changed using tokens within the queries.
The following tokens are supported:
Set the tokens as columns, and they will populate.
Tokens will be stored in table Caliban.WidgetColumnLabelToken.
You can use the toolbars on the page to add sections, containers, rows, columns, widgets or apply pre-built layouts.
Mouse hover on the Global Layout ribbon on the top left corner of the page to view the toolbar.
The Global Layout defines the overall structure of the page layout. The Global Layout toolbar includes the following options:
Button | Description |
---|---|
+ Add Side Bar | Click to add a side bar on the dashboard page. The panel is added on the left hand side of the page and subsequent panels are added in the left to right direction. To add more than one side bar, click the + Add SideBar button again. |
+ Add Top Bar | Click to add a top bar on the page. |
Pin Editor | Click to pin the toolbar to the ribbon. To unpin click the button again. |
Mouse hover on the SideBar ribbon to view the toolbar. The SideBar toolbar includes the following options:
Button | Description |
---|---|
+ Add Section | Click to add a section within the sidebar. To add more than one section , click the + Add Section button again. |
+ Add Navigation | Click to add a navigation URL in the side bar. |
Edit |
Click to change the position and size of the side panel. Position: Select left to place the side bar on the left hand side of the dashboard page or select right to move it to the right hand side of the page. Size: Select the width of the Sidebar from the drop-down. Select Yes or No in the option, to s Collapsible: Select Yes or No to set options to create a collapsible sidebar. |
Delete |
Click the ellipsis icon Note: Deleting the sidebar will delete all the sections and widgets added in the sidebar. |
Pin Editor | Click the ellipsis icon ![]() |
Mouse hover on the SideBar ribbon to view the toolbar. The SideBar toolbar includes the following options:
Note: The navigation option is only available in the Global Layout >Sidebar
Button | Description |
---|---|
Edit | Click to add a link. Click +New Link. In the Text field enter the text to displayed for the link. In the URL field, enter the URL to be mapped to the text. Click Add. |
Delete |
Click to delete the navigation bar. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Side Bar Navigation supports:
Mouse hover on the TopBar ribbon to view the toolbar. The TopBar toolbar includes the following options:
Button | Description |
---|---|
+ Add Container | Click to add a plain container to hold the dashboard sections. To add more than one container , click the + Add Container button again. |
+ Add Filter | Click to add the filter widgets. Type the widget name in the search field and click the magnifying glass icon. When you select the widget, further options are displayed. Enter Mapped Field. In the drop-down for Use, select the option to add the filter as a parameter or generate filter. Click the Back button to display the widget list. |
Delete |
Click to delete the top bar. Note: Deleting the top bar will delete all the containers and widgets added in the top bar. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Mouse hover on the TopBar ribbon in the center of the page to view the toolbar. The Main toolbar includes the following options:
Button | Description |
---|---|
Columns |
Select the Columns button and click + to add a plain container as a column to hold the dashboard sections. To add more than one container , select Columns and click + again. The containers are added as columns within the main section in the left to right direction. |
Rows |
Select the Rows button and click + to add a plain container as a row to hold the dashboard sections. To add more than one container , select Rows and click + again. The containers are added as rows within the main section in the left to right direction. Note: If the main section already has containers added as rows, the new rows are added below the containers at the bottom of the page. |
Main Scroll |
Click to apply main scroll if your dashboard has one single page without sections. It will be added as a single page scroll navigation. |
Sections Scroll | Click to apply the sections scroll if the main section is further divided into sub-sections and containers. This option will add the scroll navigation on each of the section and containers. |
Apply Layout | Click to apply pre-built layout on the dashboard page. There are 3 options available. Select the option to auto apply the layout. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Mouse hover on the Section ribbon to view the toolbar. The section toolbar includes the following options:
Button | Description |
---|---|
Edit |
Click to Edit the section details. Click Save to apply the changes.
|
+ Add Row |
Click to add a row within the section. To add more than one container , click the + Add Row button again. |
+ Add Tab |
Click to add a tab in the section. To add more than one tab, click the +Add Tab button again. |
Switch to Container | Click to switch the section mode to a plain container. |
Delete |
Click to delete the section. Note: Deleting the section will delete all the rows, tabs, and containers added in the section. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Mouse hover on the Container ribbon to view the toobar. The Container toolbar includes the following options:
Button | Description |
---|---|
Columns |
Select the Columns button and click + to add a plain container as a column to hold the dashboard sections. To add more than one container , select Columns and click + again. The containers are added as columns within the main section in the left to right direction. |
Rows |
Select the Rows button and click + to add a plain container as a row to hold the dashboard sections. To add more than one container , select Rows and click + again. The containers are added as rows within the main section in the left to right direction. Note: If the main section already has containers added as rows, the new rows are added below the containers at the bottom of the page. |
Switch to Section |
Select to switch the container mode back to section. Note: This option is displayed if the section mode is switched to container. |
Delete |
Click to delete the container. Note: Deleting the container will delete all the columns, rows added in the container. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Mouse hover on the Row ribbon to view the toolbar. The row toolbar includes the following options:
Button | Description |
---|---|
+ Add Cell |
Click to add a container cell within the row. To add more than one container , click the + Add Cell button again. The cells are added as columns within the rows. |
Delete |
Click to delete the row. Note: Deleting the row will delete all the cells and widgets added in the row. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Mouse hover on the Cell ribbon to view the toolbar. The cell toolbar includes the following options:
Button | Description |
---|---|
+ Add Widget |
Click to add a widget. Type the widget name in the search field and click the magnifying glass icon. |
Replace Widget | Click to replace the widget. Type the widget name in the search field and click the magnifying glass icon. |
Connections |
Click to connect filters with the widgets used in the dashboard. Read here for detailed instructions to set connection filters. |
Edit |
Click to edit the cell details. Click Save to apply the changes.
|
+ Add Tab | Click to add a tab within the cell. To add more than one tab, click the +Add Tab button again. |
Delete |
Click to delete the cell. Note: Deleting the cell will delete all the widgets and tabs added in the cell. |
Pin Editor | Click the Pin Editor button to pin the toolbar to the ribbon. To unpin click the button again. |
Select the widget you want to connect the filter with and in the cell toolbar click Connections .
In the pop-up dialog, two options are displayed, Filters & Filter Widgets.
Default Value: Enter a default value to appear on the dashboard.
Use: Select the Generate Filter option to filter the values on the dashboard based on the option selected on the filter, to pass the filter as a parameter (defined variable), select Pass as Parameter.
Tip: Single click drill through reports can also be configured at the Grid widget column level. Read here for detailed instructions to add Grid widgets and configure single click drill through from grid columns.
This option allows you to drill down and filter the information in the target dashboard as per the page filters applied in the source dashboard. For e.g. If the data in the source dashboard is filtered by a specific office filter then the data in the target dashboard will also be filtered by that specific office filter. Filters applied in the first dashboard will be mapped to the second dashboard when drilling through.
Note: Both the dashboards must have the same global page filters applied. (For e.g. Period, Office, & Department)
For e.g. https://yourtenant.prosperoware.io/WidgetPage/5474/LoadWidgetPage?dashboardId=147
image 1 | image 2 |
Note: The mapped field in the filters from the source dashboard to the target dashboard is passed as a parameter. This parameter must be defined in the target page widget query.